home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / programm / GNUSH22 / README.TXT < prev   
Encoding:
Text File  |  1994-08-07  |  7.8 KB  |  241 lines
  1. Bemerkungen zu GNUShell
  2. =======================
  3.  
  4. Projektfiles
  5. ------------
  6. Die GNUShell Projektfiles sind in ihrer Syntax an die Projektfiles von
  7. Pure/Turbo C angelehnt:
  8.  
  9. Projektfile ::= Target + Optionen + '=' + { Source }
  10.  
  11. Target ::= 'Targetfilename'
  12.  
  13. Optionen ::= (CompilerOption) + (AssemblerOption) + (LinkerOption)
  14.  
  15. CompilerOption ::= '.C' + '[' + { GnuOption } + ']'
  16.  
  17. AssemblerOption ::= '.S' + '[' + { GnuOption } + ']'
  18.  
  19. LinkerOption ::= '.L' + '[' + { GnuOption } + ']'
  20.  
  21. GNUOption :== '-' + TEXT
  22.  
  23. Source ::= SourceFilename + (Abhängigkeit) + SourceOption
  24.  
  25. SourceFilename ::= 'Filename'
  26.  
  27. Abhängigkeit ::= '(' + 'Filename' + { ',' Filename } + ')'
  28.  
  29. SourceOption ::= '[' + { GNUOption } + ']'
  30.  
  31. Beispiel: Projektfile:
  32.  
  33. Mit dem folgenden Projektfile wurde z.B. die GNUShell übersetzt:
  34.  
  35. # =========================
  36. # Projektfile fuer GNUShell
  37. # =========================
  38. GNUSHELL.PRG
  39. .C
  40. [
  41.   -c -O2 -ansi -mshort -D__TCC_COMPAT__
  42.   -Wall
  43.   -Wconversion
  44.   -Wmissing-prototypes
  45.   -pedantic
  46. ]
  47. =
  48. GNUALLOC.C
  49. GNUENV.C
  50. GNUERR.C
  51. GNUFILE.C
  52. GNUINFO.C
  53. GNULEX.C
  54. GNULOG.C
  55. GNUMAKE.C
  56. GNUMENU.C
  57. GNUPATH.C
  58. GNUPARSE.C
  59. GNUSHELL.C
  60. GNUSHOW.C
  61. GNUTEXT.C
  62. GEM16.OLB
  63. GNU16.OLB
  64.  
  65. Weitere Bemerkungen
  66. -------------------
  67. Die Option ".C [-c]" sollte immer vorhanden sein.
  68.  
  69. Eine laufende Compilation kann durch (wiederholten) Tastendruck abgebrochen
  70. werden. Dabei sollte nicht die Return-Taste verwendet werden, da eine
  71. Sicherheitsabfrage mit Defaultwert 'weiter' erfolgt.
  72.  
  73. Registrierung
  74. -------------
  75. GNUShell ist Shareware. Bei regelm"assiger Benutzung sind die Anwender
  76. verpflichtet, die Sharewaregeb"uhr von DM/sFr 20.- an folgende Adresse
  77. zu entrichten:
  78.  
  79. Roland Schäuble
  80. Dattikonstr. 2
  81. CH-8730 Uznach
  82. Tel. (055) 72 41 34
  83.  
  84. Durch die Registrierung kommt der Anwender in den Genuss folgender
  85. Vorteile:
  86.  
  87. Er wird von mir in die Liste der registrierten Anwender aufgenommen.
  88.  
  89. Ein registrierter Anwender bekommt die zum Zeitpunkt der
  90. Registrierung aktuelle Version von GNUShell von mir zugesandt
  91.  
  92. Zudem erhält er alle Sourcefiles und das Projektfile, mit dem
  93. GNUShell zusammengebaut werden kann (GNUShell kann sowohl mit dem GNU
  94. C-Compiler, wie auch mit Pure C übersetzt werden).
  95.  
  96. Registrierte Anwender erhalten die Dokumentation zugesandt.
  97.  
  98. Ein registrierter Anwender wird über (wesentliche) Neuerungen
  99. von GNUShell unterrichtet.
  100.  
  101. Ein registrierter Anwender kann jederzeit gegen Einsendung einer
  102. Leerdiskette die aktuelle Version von GNUShell bei mir beziehen.
  103.  
  104. Bei Fragen und Problemen stehe ich im Rahmen meiner
  105. Möglichkeiten zur Verfügung.
  106.  
  107. Anregungen
  108. ----------
  109. Anregungen, Problemmeldungen und Verbesserungs- und Änderungswünsche
  110. bitte an folgende Adresse:
  111.  
  112. Roland Schäuble
  113. Dattikonstr. 2
  114.  
  115. CH-8730 Uznach
  116. eMail: CZSRO@zcvx00.decnet.ascom.ch
  117.  
  118. Bei Problemen bitte immer Versionsnummer und Konfiguration angeben.
  119.  
  120. History
  121. -------
  122. Version 1.1 2-Okt-1993
  123.   Erste gültige Ausgabe.
  124.  
  125. Version 1.2 10-Okt-1993
  126.   Überprüfung, ob Inputfiles aus Abhängigkeitsliste vorhanden.
  127.   Überprüfung, ob Sourcefile vorhanden.
  128.   Korrektur Fehler, wenn GNUShell nicht auf gleichem Drive, wie Source.
  129.   Neuer Menu-Eintrag "Edit .*".
  130.   Fehlermeldung, wenn Projektfile nicht gefunden.
  131.   Korrektur im Zusammenhang mit GDOS.
  132.   Verbesserungen des Handling der Text-Windows.
  133.  
  134. Version 1.3 4-Nov-1993
  135.   Übergabe der Filenamen in Kleinschrift bei Option Compile...
  136.   Damit wird "file.cxx" als C++-Source erkannt und nicht als Library.
  137.  
  138. Version 1.4 18-Nov-1993
  139.   Korrektur bei den Optionen "Compile" sowie "Compile & Link":
  140.   Es wird jetzt -oFilename erzeugt und nicht mehr -o filename,
  141.   was zu einem Fehler führte.
  142.  
  143. Version 1.5 9-Dez-1993
  144.   Sichern des Info-Files unter anderem Filenamen funktioniert jetzt.
  145.   Erweiterung User-Environment-Variablen.
  146.   Ausgaben des Compilers auf stdout werden jetzt auch in das
  147.   Message-Window umgeleitet.
  148.   Letzter Pfad und Name bei Execute und Delete wird behalten.
  149.   Mehr Flexibilität bei der Konfiguration des Editors.
  150.   Beim Editieren von Sourcefiles kann z.B. ein vorhandenes Messagefile in
  151.   den 2. Buffer genommen werden.
  152.   Aus .MSG-Files werden .LOG-Files.
  153.   Verbesserte Behandlung des Logwindow-"Fullers".
  154.   Im Infofile sind sowohl die Namen der Environmentvariablen zu sehen,
  155.   wie auch die Definition.
  156.  
  157. Version 1.6 15-Dez-1993
  158.   Nach 'Execute' eines Programmes wird der Returnstatus angezeigt.
  159.   Die Umleitung von stdout und stderr nach dem Compilieren oder
  160.   Linken wird jetzt durch Schliessen von stdout und stderr
  161.   rückgängig gemacht (funktioniert aber erst ab GEMDOS 0.15 korrekt).
  162.   Infofile mit Namen versehen. Damit werden alte Info-Files nicht
  163.   bei jeder Änderung der Struktur unbrauchbar.
  164.   Beim 'Execute' eines TTP-Programmes können jetzt Parameter übergeben
  165.   werden.
  166.  
  167. Version 1.7 2-Jan-1994
  168.   Fehler bei der Behandlung von Abhängigkeitslisten behoben. Der
  169.   Datumsvergleich erfolgt jetzt zwischen dem Objektfile und dem File
  170.   aus der Liste anstatt wie bisher zwischen dem Sourcefile und
  171.   dem File aus der Liste.
  172.   Das Logfile wird jetzt auf das Directory des Sourcefiles
  173.   geschrieben, damit es der Editor immer finden kann.
  174.   Weitere Probleme im Zusammenhang mit der Anzeige von Logfiles im
  175.   Textwindow behoben.
  176.   Neuer Menupunkt "Close Logwindows" eingeführt.
  177.   Peinlicher Fehler beim Setup des Environments behoben, der zu einem
  178.   Endlosloop nach Drücken von OK führte.
  179.   Nebst %s und %l ist jetzt auch %n=Zeilennummer als Editorparameter
  180.   einstellbar.
  181.  
  182. Version 1.8 1-Mar-1994
  183.   Logwindow wird bei Eröffnung nicht mehr 2 mal gezeichnet.
  184.   Problem bei mehr als 7 Logwindows behoben.
  185.   Korrekte Verarbeitung von Pfadnamen, die '.' beinhalten.
  186.   Optimierung beim Zeichnen der Logwindows.
  187.   Listenverarbeitung effizienter.
  188.  
  189. Version 1.9 11-Apr-1994
  190.   Fehler (GemDos Error 34) bei Compile & Link" bzw. "Link" von einem
  191.   anderen Drive aus behoben.
  192.  
  193. Version 2.0 29-Apr-1994
  194.   Schwerer Memory-Fehler bei der Behandlung von Textwindows behoben
  195.   (Wahrscheinlich Ursache für Probleme mit dem TT).
  196.   Fehler beim Resize von Textwindows behoben.
  197.   Abfrage bei "Quit" und Setup-Änderungen.
  198.   Compilation der Shell jetzt auch mit -pedantic etc. möglich.
  199.   GEMDOS-Fehlerprüfung erweitert.
  200.  
  201. Version 2.1 15-Jun-1994
  202.   Nur noch ein Logwindow mit allen Meldungen.
  203.   Das Logwindow wird vor dem Start eines anderen Programmes
  204.   geschlossen, damit wieder 7 Fenster "frei" sind.
  205.   Der Menueintrag "Close Logwindows" entfällt.
  206.   Weniger Speicherbedarf für das Logwindow.
  207.   Möglichkeit, ein RCS (Resource Construction Set) einzubeziehen.
  208.   Bei "Make all" werden nur noch diejenigen Files in der deleting...
  209.   Box angezeigt, die tatsächlich vorhanden sind (und daher gelöscht
  210.   werden).
  211.   Als Argv-Parameter kann beim Starten ein Projektfile übergeben
  212.   werden. Damit kann z.B. mit der Tera-Shell ein Projektfile auf
  213.   GNUSHELL.PRG gezogen werden, womit es zum aktuellen Projektfile
  214.   wird.
  215.  
  216. Version 2.2 2-Jun-1994
  217.   Files mit der Extention ".o" bzw ".O" im Projektfile werden jetzt
  218.   korrekt behandelt, d.h. nur gelinkt und nicht mehr als Libraries
  219.   angesehen.
  220.  
  221.  
  222. Bekannte Probleme:
  223.   Welcher Pfad soll bei 'Execute' eingestellt werden?
  224.   Zur Zeit ist es der Pfad des auszuführenden Programmes
  225.   eingestellt. Damit können GEM-Programme ihre Resourcefiles finden.
  226.   Andererseits ist dies z.B. für GNU Make ein Hinderniss.
  227.  
  228. In Zukunft...
  229.   ...Wäre es toll, wenn auf Doppelklick im Logwindow der Editor mit
  230.      dem entsprechenden File auf der richtigen Linie gestartet werden
  231.      könnte.
  232.  
  233.   ...Könnte vielleicht GNU MAKE als Alternatives Make angeboten werden.
  234.      Das Problem dabei ist, dass GNUShell keine Kommandoshell zur
  235.      Verfügung stellt. GNU MAKE ist aber auf eine solche angewiesen.
  236.  
  237.   ...Sollte es eine Möglichkeit geben, den GNU Debugger zu verwenden.
  238.      Zum Debuggen muss zweimal mit verschiedenen Optionen
  239.      gelinkt werden können.
  240.  
  241.